home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #6 / Amiga Plus CD - 2004 - No. 06.iso / AmiSoft / Misc / emu / vic-emu-tools.lha / vic-emu-tools / HowToUseVic-emu.txt next >
Text File  |  2004-05-25  |  6KB  |  195 lines
  1. Vic20 emulation on Amiga
  2.  
  3. ---
  4.  
  5. The only choice (for 680x0 amigas) seems to be the emulator vic-emu:
  6. (Vic Emulator V0.65)
  7. ftp://de.aminet.net/pub/aminet/misc/emu/vicV0.65.lha
  8.  
  9. For PowerPC there also seems to be MESS:
  10. http://www.mess.org/
  11.  
  12. But as I have no PowerPC, this text will be about vic-emu V0.65.
  13.  
  14. ---
  15.  
  16. Vic-emu is far from perfect, and has many bugs. This text is about
  17. how to work around them and get an almost acceptable vic emulator.
  18.  
  19. I am running it on a 40Mhz 68040 (Blizzard1240).
  20.  
  21. First, the settings. I set both KEY and SCREEN to 0 in the info file.
  22. If running from shell, the equivavent is:
  23.  
  24. vic-20 -k 0 -s 0
  25.  
  26. For some games, for example Omega Race, this is enough. Smooth and
  27. nice emulation. But for most other games and for basic, the emulation
  28. is running way too fast. Because of this, I made a little program
  29. slowing down the processor - The included "SlowDown".
  30.  
  31. With a setting of 5000 (and type A) in my "slow down" program, most
  32. basic and many games runs smoothly.
  33.  
  34. The default vic-emu screen mode is a bad one. I use MCP to promote the
  35. screen into a DblNTSC lores noflicker. That makes the aspect ratio more
  36. vic-like.
  37.  
  38. ---
  39.  
  40. That was about the settings, now about loading programs into vic-emu.
  41.  
  42. When you use the LOAD command in the vic emu, a file requester pops up
  43. on the Workbench to selet file. BUT, you can't load a file from a root
  44. directory. If you for example try to load RAM:program.prg, then you
  45. will get a verify error. So you must have the vic program in a sub
  46. directory. For example RAM:files/program.prg ....That works. Directly
  47. after loading, press Return one extra time, or the keys will be locked
  48. in some bug mode. Also, sometimes when going to the vic screen, you
  49. need to press SHIFT to get out of some shift-lock mode. In other
  50. words, 
  51.  
  52. LOAD
  53. (Select file)
  54. (OK READY)
  55. Press Return
  56. RUN
  57.  
  58. It seems like it always loads into the basic memory (just ,8) and
  59. never into the program's original position (,8,1) even if you specify
  60. ,8,1 (That's quite disturbing). So if you want to load a machine
  61. language routine, you have to first move the basic memory position
  62. to where the program should be located and then use LOAD. You do
  63. this by Pokeing to position 43 and 44. Here is an example for loading
  64. my program "Tribbles:" (http://home.tiscali.se/~boray/datormuseum/tribbles.html)
  65.  
  66.  
  67.   vic-20 -k 0 -s 0 $2000 ram8
  68.  
  69.   (Loading the machine language and graphics part)
  70.   POKE43,0:POKE44,20
  71.   LOAD
  72.   (select "trill.gfx")
  73.   (when loaded, press return)
  74.  
  75.   (Loading the basic part)
  76.   POKE7168,0:POKE43,1:POKE44,28:NEW
  77.   LOAD
  78.   (select "tribbles part 2")
  79.   (when loaded press return)
  80.  
  81.   RUN
  82.  
  83.  
  84. But how do I know what values to poke...? Well, That's easy. You just
  85. use the program "PRGinfo" included in this package and it will tell
  86. you what to do. If I for example use it on the file "trill.gfx" above,
  87. this will be the output:
  88.  
  89.  
  90.   CBM PRG File Info V1.0 - By Anders Persson 2004 (listen.to/boray)
  91.  
  92.   File: TRILL-GFX
  93.  
  94.   Address: 5120 to 7167   = 2047 bytes
  95.       Hex: $1400 to $1BFF
  96.  
  97.   My guess:
  98.   Machine language or data for Vic20 graphics memory (standard 5K) or C64/128.
  99.  
  100.   LOAD "TRILL-GFX",8,1
  101.   SYS 5120 (maybe)
  102.  
  103.   Vic-Emu before LOAD:
  104.   POKE 43, 0 :POKE 44, 20 
  105.  
  106.  
  107. But for some reason, pokeing before loading doesn't work with plugin
  108. images for block 5 even if you have set vic-emu to have RAM there...
  109. Then vic-emu will crash. But luckily, there is another way of loading those...
  110.  
  111. When loading plugin games, you must start from shell, and do like
  112. this:
  113.  
  114. CD Work:Emulation/vic/
  115. vic-20 -k 0 -s 0 $9ffe "Omega Race.prg"
  116.  
  117. (Mounts the file "Omega Race.prg" at adress $9ffe.) The normal address
  118. would be $a000, but (unlike Vice) vic-emu doesn't recognize the CBM
  119. file format when doing this, so you have to load it into pos $9ffe to
  120. get rid of the two first bytes of the file. AND the file MUST be
  121. located in the same directory as the emulator, or it will hang.
  122.  
  123. PRGinfo again gives you the needed info:
  124.  
  125.   CBM PRG File Info V1.0 - By Anders Persson 2004 (listen.to/boray)
  126.  
  127.   File: OMEGA RACE.PRG
  128.  
  129.   Address: 40960 to 49152   = 8192 bytes
  130.       Hex: $A000 to $C000
  131.  
  132.   My guess:
  133.   Vic20 8K plugin for block 5.
  134.  
  135.   LOAD "OMEGA RACE.PRG",8,1
  136.   SYS 64802 (probably)
  137.  
  138.   Vic-Emu command line $-load address: $9FFE
  139.  
  140.   Vic-Emu before LOAD:
  141.   POKE 43, 0 :POKE 44, 160 
  142.   NOTE: Crashes on vic-emu 0.65! Use the command line $-load address instead.
  143.  
  144.  
  145. Luckily for you I have also made a little script that does all that for you.
  146. (The included "vicstart"). Put it in S: and protect it +S. Put PRGInfo in C:
  147. and assign VIC: to the dir that contains vic-emu. Then you can just do this
  148. to run a plugin game:
  149.  
  150.   vicstart "omega race.prg"
  151.  
  152. or for a two part cartridge:
  153.  
  154.   vicstart "apple panic-6000.prg" "apple panic-a000.prg" 
  155.  
  156.  
  157. Nice? I think so! ;-)
  158.  
  159. ---
  160.  
  161. When saving programs on vic-emu, you just do like usual:
  162. SAVE "PROGRAM",8
  163.  
  164. ...and it will be saved in vic-emu's dirctory.
  165.  
  166. ---
  167.  
  168. There are two more programs included in this package:
  169.  
  170. * MakeLoCase - Program to renames files to only lo case letters.
  171.  
  172. * MakeUCase - Program to rename files to only upper case
  173.   letters and removes the .prg extension if any.
  174.  
  175. These are useful when transfering files from and to your
  176. 1541 drive (with for example "Easy1541"), for example when
  177. copying files you have downloaded from internet to a real vic.
  178.  
  179. ---
  180.  
  181. My Vic-20 software:
  182. http://home.worldonline.se/~boray/datormuseum/vic20software.html
  183. or
  184. http://home.tiscali.se/~boray/datormuseum/vic20software.html
  185.  
  186. My Amiga Software:
  187. http://user.tninet.se/~hlw771b/amigastuff.html
  188.  
  189. ---
  190.  
  191. Well, Good luck!
  192.  
  193. /Anders
  194.  
  195.